home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / catD / sgset.z / sgset
Encoding:
Text File  |  2002-10-03  |  3.4 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ssssggggsssseeeetttt((((DDDD3333XXXX))))                                                          ssssggggsssseeeetttt((((DDDD3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _ssss_gggg_ssss_eeee_tttt - assign physical addresses to a vector of software scatter-gather
  10.      registers
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _""""_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_""""
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _""""_ssss_yyyy_ssss_////_bbbb_uuuu_ffff_...._hhhh_""""
  15.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _""""_ssss_yyyy_ssss_////_ssss_gggg_...._hhhh_""""
  16.  
  17.      _ssss_gggg_ssss_eeee_tttt_((((_ssss_tttt_rrrr_uuuu_cccc_tttt _bbbb_uuuu_ffff _****_b_p_,,,, _ssss_tttt_rrrr_uuuu_cccc_tttt _ssss_gggg _****_v_e_c_,,,, _iiii_nnnn_tttt _m_a_x_v_e_c_,,,, _iiii_nnnn_tttt _****_r_e_s_i_d_))))_;;;;
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      _ssss_gggg_ssss_eeee_tttt provides a utility to manage a software equivalent of scatter-
  21.      gather registers for devices that do not implement them. Based on the
  22.      information provided in the _b_u_f type structure pointed to by _b_p, this
  23.      routine fills in _m_a_x_v_e_c entries of a scatter-gather vector _v_e_c. If the
  24.      number of vectors required to perform the transfer exceeds _m_a_x_v_e_c, the
  25.      contents of _r_e_s_i_d is set to the number of pages remaining.
  26.  
  27.      The buffer must not be for mapped address (_B__P_A_G_E_I_O for _bbbb_uuuu_ffff(40) not set).
  28.  
  29.      The scatter gather entries are formatted in the following structure,
  30.      excerpted from _s_y_s/_s_g._h:
  31.      _ssss_tttt_rrrr_uuuu_cccc_tttt _ssss_gggg _{{{{
  32.              _uuuu_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd _llll_oooo_nnnn_gggg _ssss_gggg______iiii_oooo_aaaa_dddd_dddd_rrrr_;;;; _////_**** _pppp_hhhh_yyyy_ssss_iiii_cccc_aaaa_llll _aaaa_dddd_dddd_rrrr_ssss _oooo_ffff _pppp_aaaa_gggg_eeee _****_////
  33.              _uuuu_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd _llll_oooo_nnnn_gggg _ssss_gggg______bbbb_cccc_oooo_uuuu_nnnn_tttt_;;;; _////_**** _bbbb_yyyy_tttt_eeee _cccc_oooo_uuuu_nnnn_tttt _oooo_ffff _tttt_rrrr_aaaa_nnnn_ssss_ffff_eeee_rrrr _****_////
  34.      _}}}}_;;;;
  35.  
  36.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  37.      The number of vector entries used.
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.